NOTMATCH
The NOTMATCH
field specifier (case sensitive) allows you to find documents in which at least one instance of the specified fields contains a value that does not match the specified string.
If there are one or more instances of a particular field in the document, the document returns if at least one instance does not contain any of the specified strings, even if another instance of the field does match. The document does not return if all instances of the specified fields contain an exact match of one of the specified strings.
NOTE: You can optimize the field specifier speed by restricting the field to the
To use the NOTMATCH
field specifier against fields that were added using the
Format
FieldText=NOTMATCH{yourStrings}:yourFields
yourStrings
|
One or more strings. A document returns only if at least one instance of one of NOTE: Strings in the query should be percent-encoded. This ensures that any commas or curly braces that are part of a string are not interpreted as query syntax. If you are sending HTTP requests using the content-type |
yourFields
|
One or more fields. A document returns only if it contains one of these fields, and if the value in at least one instance of the field does not exactly match any of yourStrings . Separate multiple fields with colons (: ). There must be no space before or after a colon. |
Example
FieldText=NOTMATCH{cat}:ANIMAL
At least one instance of the ANIMAL
field must have a value other than cat
for the document to return as a result.
For example, if a document contains only:
#DREFIELD ANIMAL="cat"
Then it does not return as a result.
However, if the document contains:
#DREFIELD ANIMAL="cat"
#DREFIELD ANIMAL="dog"
Then it returns as a result, as one of the ANIMAL
fields does not contain the value cat
.
NOTE: To find documents in which the specified string is not present in any instance of the specified field, use the MATCH specifier with the Boolean operator NOT
. For example, FieldText=NOT+MATCH{cat}:ANIMAL
does not return any documents that have a ANIMAL
field with the value cat
, even if there are other ANIMAL
fields with different values.
See Also
-
MATCH Field Specifier.